//=============================================================================
// System  : MatchKit
// File    : IMatchMappingEvents.cs
// Author  : Fabio Bussu  (matchkit@fabiobussu.it)
// Updated : 04/16/2013
// Note    : Copyright 2013, Fabio Bussu, All rights reserved
//
// This code is published under the Microsoft Public License (Ms-PL). A copy
// of the license should be distributed with the code.  It can also be found
// at the project website: http://matchkit.codeplex.com. This notice, the
// author's name, and all copyright notices must remain intact in all
// applications, documentation, and source files.
//
// Version     Date     Who  Comments
// ============================================================================
// 1.0.0.0  04/16/2013   FB  First draft
//=============================================================================

namespace MatchKit.ObjectMapping
{
	/// <summary>
	/// Provides the abstraction to permits a matchable class to handle the events of assigning a matched 
	/// class member and the completed matched class.
	/// </summary>
	/// <conceptualLink target="7e399cd8-5cfa-4616-a3c9-abcc9344dabc" />
	/// <conceptualLink target="0a06b2a9-5f58-409a-ba62-639cfd77bca7" />
	public interface IMatchMappingEvents
	{
		/// <summary>
		/// Handles the assigning of a matched member. Mapping process invokes this method before setting 
		/// the value to the matched field or property.
		/// </summary>
		/// <param name="e">Informations about the mapping operation.</param>
		void OnMatchingMember(MatchMappingArgs e);

		/// <summary>
		/// Handles the completion of a matched instance. Mapping process invokes this method after all matchable 
		/// members are successful matched.
		/// </summary>
		void OnMatchedInstance();
	}
}
